home *** CD-ROM | disk | FTP | other *** search
/ Die Speccy' 97 / Die Speccy' 97.iso / amiga_system / the_aminet / util / boot / mkick19.lha / README < prev    next >
Text File  |  1995-01-01  |  9KB  |  229 lines
  1. ==============================================================================
  2.  
  3.                          MJSoft's Kicker -- MKick 1.9
  4.  
  5.               (c) 1992-1995 Martin Mares, MJSoft System Software
  6.  
  7. ==============================================================================
  8.  
  9.  
  10. What is MKick
  11. -------------
  12.  
  13.    MKick is a replacement of KickIt, ZKick, LKick and Rekick kickers for use on
  14. machines with kickstart 1.2 or 1.3 in ROM (It also tries to be as powerful as
  15. SinSoft's SKick).
  16.  
  17.    The main advantages of MKick are:
  18.  
  19.  - ability to relocate any Kickstart to CHIP, FAST (C0-RAM), NON-AUTOCONFIG
  20.    RAM or EXPANSION RAM if a relocation table is supplied.
  21.  
  22.  - standard operation (like ZKick) if the relocation table is not available.
  23.  
  24.  - reading of both KickIt and ROM Image Kickstart formats (encrypted
  25.    beta-ROMs for A600 must be converted by MakeKick)
  26.  
  27.  - patch function using supplied patch table (may correct known Kickstart bugs).
  28.  
  29.  - can be started from both the command line and the Workbench.
  30.  
  31.  - Graphic User Interface (GUI).
  32.  
  33.  - Small code size, because it's written completely in assembly.
  34.  
  35.  - loaded Kickstart survives user reset and crashes (when the ExecBase is not
  36.    destroyed).
  37.  
  38.  - C0-RAM salvage: many Kickstarts perform destructive tests of C0-RAM (FAST
  39.    RAM). MKick stores critical bytes in its own storage and restores their
  40.    contents after memory tests.
  41.  
  42.  - If you have Kickstart 39.106 or higher, the alert timing constant
  43.    (execbase+$20E) won't be lost during reboot.
  44.  
  45.  - Non-autoconfig can be added automatically without using special resident
  46.    utilities.
  47.  
  48.  - ROM Kickstart can be relocated to RAM. This speeds up system operation on
  49.    the most of accelerated systems (e.g. GVP A530 Turbo). In this case, you
  50.    needn't the Kickstart image file, MKick will load it directly from your ROM.
  51.  
  52.  - Waits for all disks to be validated before performing any operation.
  53.  
  54.  - New memlist named Kickstart is created if the KS image is not stored in
  55.    one of original memlists. This prevents MonAm from treating KS image
  56.    as out-of-memory space.
  57.  
  58.  - Ability to get rid of resident modules by simply pressing the left mouse
  59.    button at correct time (see below).
  60.  
  61.  - ExecBase can be moved to expansion or non-autoconfig fast memory, which
  62.    slightly increases system speed. (In such case, it is sometimes not possible
  63.    to survive reboots -- see discussion in MKick.doc.)
  64.  
  65.  - CPU vectors can be relocated to fast memory, which increases system
  66.    performance (only possible on 68010+).
  67.  
  68.  - Memory region removal supported allowing MKick to work correctly with some
  69.    tricky RAM configurations (as 5M mirrored to 8M on GVP A530 etc.).
  70.  
  71.  
  72. Copyright
  73. ---------
  74.  
  75.    MKick and all the utilities in this package, including their documentation,
  76. with the exception of KickStat are Copyright (C) 1995 Martin Mares, Prague,
  77. Czech Republic.
  78.  
  79.    The  KickStat  utility  is  Copyright  (C) 1995 SinSoft and is included with
  80. permission of its author.
  81.  
  82.    This  archive  can  be  freely  redistributed as long as all of its files are
  83. included   in   their   original   form  without  any  additions,  deletions  or
  84. modifications  (excluding addition of other README-style files and icons) and no
  85. more  than a nominal fee is charged for its distribution.  All copyright notices
  86. in  the  programs and accompanying documentation files must remain intact.  It's
  87. especially  forbidden  to add various '.displayme' files and BBS advertisements.
  88. This style of distribution is generally known as FREEWARE.
  89.  
  90.    There's one exception to these rules -- the author allows all the utilities
  91. to be included in SKick archives.
  92.  
  93.    This package is provided as is, any warranties cannot be applied.  Any
  94. usage of this program or other parts of this archive will be done at your own
  95. risk!
  96.  
  97.  
  98. Contents
  99. --------
  100.  
  101.    README             - this file
  102.    README.BUGREPORTS  - how to write MKick bug reports
  103.    README.3.1         - additional information concerning 3.1 Kickstarts
  104.    HISTORY            - history of development
  105.  
  106.    MKick              - the kicker itself
  107.    MKick.info         - icon
  108.  
  109.    MakeKick           - utility for creation of Kickstart header files
  110.    Kick2RTB           - converts Kickstart header files to SKick format
  111.    MakeKickDisk       - makes special boot disk for fast booting of Kickstarts
  112.    SwitchScript       - utility for easy switching of startup scripts
  113.    SumKick            - calculates checksum of Kickstart image
  114.    KickStat           - shows information about currently running Kickstart
  115.    KickInfo           - utility showing information about Kickstart file
  116.    FastEBPatch        - set of patches for operation with ExecBase in exp. RAM
  117.    AddModule          - utility for easy addition of resident modules
  118.  
  119.    *.doc              - Documentation
  120.  
  121.    KSHD/*.kick        - Kickstart headers for various Kickstarts
  122.    KSHD/*.kshd        - source files for Kickstart headers
  123.  
  124.    Delta/*            - delta files to recover patched Kickstarts
  125.                         (see delta/README for more info)
  126.  
  127.  
  128. Included Kickstart headers
  129. --------------------------
  130.  
  131.    The  Kickstart  header  files containing the relocation table and information
  132. needed  to load the Kickstart are supplied for following Kickstarts:
  133.  
  134.    Kick33180.A500            standard 1.2 for A500/A2000
  135.    Kick34005.A500            standard 1.3 for A500/A2000
  136.    Kick37175.A500            standard 2.04 for A500+
  137.    Kick39046.A500.BETA       beta-version of 3.0
  138.    Kick39106.A1200           standard 3.0 for A1200
  139.    Kick39110.A500.BETA       beta-version of 3.0
  140.    Kick39115.A3000.BETA      beta-version of 3.0
  141.    Kick39115.A3000SK.BETA    beta-version of 3.0, SuperKickstart file
  142.    Kick40003.A3000.BETA      beta-version of 3.0, SuperKickstart file
  143.    Kick40038.A600.BETA       beta-version of 3.1
  144.    Kick40063.A600            3.1 ROM for A600
  145.    Kick40068.A600            3.1 Rekick file for A600
  146.    Kick40068.A1200           3.1 ROM for A1200 (requires 68020+)
  147.    Kick40068.A4000           3.1 ROM for A4000 (requires 68020+)
  148.    Kick40070.A600            3.1 Rekick file for A600
  149.    Kick40070.A600.F8         3.1 ROM for A600 (at $F80000)
  150.    Kick40070.A3000           3.1 SuperKickstart for A3000 (requires 68020+881)
  151.    Kick40070.A4000           3.1 ROM for A4000 (requires 68020+)
  152.    Kick40070.A4000T          3.1 ROM for A4000T (requires 68020+)
  153.  
  154.    For 3.1 Kickstarts, see notes in README.3.1.
  155.  
  156.    If you have a Kickstart which is not included in this list, try to download
  157. latest version of SKick if it contains RTB and PAT files for your Kickstart
  158. and convert them by the MakeKick utility (AUTO option).
  159.  
  160.  
  161. System requirements:
  162. --------------------
  163.  
  164.   - Amiga 500, 1000 or 2000
  165.  
  166.   - Minimally 1 meg of RAM (all possible combinations)
  167.  
  168.   - Kickstart 1.2 or 1.3 in ROM
  169.  
  170.   - arp.library in the LIBS: directory
  171.  
  172.  
  173. Installation:
  174. -------------
  175.  
  176.    (1) Create DEVS:Kickstarts and copy all your Kickstart images to it. This
  177.        directory is searched automatically in the GUI mode (can be overriden
  178.        by the KICKDIR option if you want).
  179.  
  180.    (2) Find proper Kickstart header files (you may find a list of them above).
  181.        Rename Kickstart files to match the names of the header files -- for
  182.        kick39115.A3000.BETA.kshd, the Kickstart image should be renamed to
  183.        kick39115.A3000.BETA. (It's also possible to rename the header files
  184.        according to names of Kickstart images, but it's a bit confusing.)
  185.  
  186.        THERE ARE NO KICKSTART IMAGES IN THIS ARCHIVE
  187.  
  188.        If you don't know the exact name of .kick file to be used, consult the
  189.        KickInfo utility (see its doc for how to do it).
  190.  
  191.    (3) Copy the executable files to some place, preferably to some that is
  192.        included in PATH. It's better to copy the MKick executable itself to
  193.        C: to allow using it before any paths are set.
  194.  
  195.    (4) If you want MKick to work automatically, insert it as a FIRST line of
  196.        your Startup-sequence. It allows MKick to handle all operations requiring
  197.        system reboot (switching from one Kickstart in RAM to another one etc.)
  198.        without user intervention.  When you hold down the left mouse button
  199.        during system reboot, the GUI screen will appear.
  200.  
  201.    (5) If you want your startup scripts to be switched according to Kickstart
  202.        version, install the SwitchScript utility (see its .doc for how to do it)
  203.  
  204.  
  205. Thanks:
  206. -------
  207.  
  208.  - to Commodore-Amiga for the Operating System.
  209.  
  210.  - to SineSoft for his SKick and a lot of good ideas.
  211.  
  212.  - to Tomas Zikmund, Petr Cisar and Stefan Stuntz for beta-testing.
  213.  
  214.  - to many people for sending me their bug reports
  215.  
  216.  
  217. Final words:
  218. ------------
  219.  
  220.    Known bugs: MKick probably doesn't work with 68040 CPU, because I have no
  221.                beta-testers with such machine and I have no documentation for
  222.                this CPU.
  223.  
  224.    Send bug reports and comments to mj@k332.feld.cvut.cz
  225.     (Before sending bug reports, you should read the README.BUGREPORTS file).
  226.  
  227.    Excuse me for my bad English and all bugs.
  228.  
  229.